home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 2000 March / macformat-088.iso / Shareware Plus / Graphics / PanoTools2.0b1 / Helpers / Readme PTStitcher < prev   
Encoding:
Text File  |  2000-01-21  |  6.4 KB  |  197 lines  |  [TEXT/ttxt]
  1. Readme PTStitcher 2.0.b1
  2.  
  3.  
  4. PTStitcher combines images to panoramic views. You simply 
  5. drop all input images onto the application icon of PTStitcher
  6. and a panoramic file to be viewed with all major VR-viewers
  7. is generated in one step.
  8.  
  9. Changes to 1.9.2:
  10. =================
  11. o Tiff-reader and ppm-reader added. Both read images
  12.   in excess of the 4k-width limit on older macs. 
  13. o Quicktime importer corrected: reads now large images
  14.   on newer macs.
  15. o PTPicker added for Macs: GUI for aligning images and
  16.   calling PTSTitcher.
  17. o Some minor erors corrected.
  18.  
  19.  
  20. Changes to 1.9.1:
  21. =================
  22. o JPEG output supported for IBM-Hotmedia support.
  23. o Folders with images can be processed like single 
  24.   images. This solves a problem with Windows
  25.   command line limitations.
  26. o Mac-version reads images through Quicktime importer.
  27.   Thus almost any format is supported, and the 'PICT'-
  28.   limitation on image size no longer applies.
  29. o Mac version has some rudimentary user interface.
  30.   Images can be loaded via menus, and there is even
  31.   a program icon.
  32. o PTAverage, the density enhancing software, is
  33.   now included in this distribution. Also included 
  34.   is a first Windows version of this program.
  35. o Bug fixes: Mode line in scripts is read correctly,
  36.   IVR-files for LivePicture Cylinders are corrected,
  37.   and some more minor fixes.
  38. o Scripting syntax for macs has been changed to that
  39.   of Windows machines, see Readme.
  40. o The Photoshop plug-in 'Panorama Tools' has been
  41.   updated, too, see the separate Readme about changes.
  42.  
  43.  
  44. Changes to 1.9.0:
  45. =================
  46. o First Windows version.
  47. o Panorama conversion capability added: Almost any 
  48.   output format can be generated using any input format.
  49. o More formats available: LivePicture Cylinder.
  50. o VRML-output now includes Zoom-tool.
  51. o Viewer scripts can be customized via templates.
  52. o Script file can be dropped together with image files
  53.   on PTStitcher. 
  54. o Some bug fixes
  55.  
  56. Changes to 1.0b1:
  57. =================
  58. o More output formats available: VRML-cubes and LivePicture-Java 
  59.   (spherical/cylindrical).
  60. o Fully Apple-scriptable: Build your Web-Panocam.
  61. o PTOptimizer finds optimum image position automatically,
  62.   see separate documentation.
  63. o More options for panorama creation: see examples.
  64. o Several bug fixes.
  65.  
  66. Changes to 1.0b0:
  67. ===============
  68. o Fixed error in PICT-reader, which only worked for 72dpi images.
  69.   (Copied faithfully from Apple's sample code site...)
  70.  
  71.  
  72. Output options:
  73. ===============
  74. o QTVR movie ready to be viewed with Quicktime plug-in.
  75.   (Windows version requires free VRMakePano utility).
  76. o Smoothmove full spherical panorama ready to be viewed 
  77.   with Infinite Images (iMove) plug-in.
  78. o RealVR full spherical and cylindrical panorama ready to 
  79.   be viewed with LivePicture's ZoomIt viewer.
  80. o LivePicture Java format: Cylindrical and Spherical        
  81.   ready to be viewed with LivePicture Applet
  82. o VRML-Background node (Cubes)    
  83.   ready to be viewed with VRML-browsers.
  84.   Viewer Script with Zoom tool generated.
  85. o JPEG-images for IBM Hotmedia format, ready to
  86.   be imported in free IBM authoring software.
  87. o Panoramic images for viewing and printing
  88. o Multilayer Photoshop file containing one image per layer for
  89.   editing.
  90.  
  91. Input options:
  92. ==============
  93. o Rectilinear lenses with any focal length
  94. o Fisheye lenses with any focal length
  95. o Panoramic cameras
  96. o Any orientation possible (multirow etc)
  97. o PSphere images, allows conversion of 
  98.   almost any format to any format.
  99. o Can read almost any format on Macs/ 
  100.   uncompressed BMP and JPEG images on Windows.
  101.  
  102. Installation:
  103. =============
  104.  
  105. Macintosh:
  106. ----------
  107. Drop the file 'pano12.lib' onto your 'System Folder'.
  108. Your system should then move it to the 'Extensions'-folder.
  109. It replaces the pano-library which comes with my
  110. Photoshop plug-in 'Panorama Tools'. This library only
  111. works with the current version 1.9.2 plug-in which
  112. is included in this package.
  113.  
  114. Windows:
  115. --------
  116. Put the library file 'pano12.dll' in your 
  117. \Windows\System directory. This library also works 
  118. with the current 1.9.2 version of the Panorama
  119. Tools plug-in. If you do not use that plug-in
  120. you can also leave the library together with
  121. PTStitcher.
  122.  
  123. General:
  124. --------
  125. The folder 'Templates' has to be in PTStitcher's
  126. directory. It contains HTML and VRML templates, which
  127. are used to generate the output files. You can edit
  128. them to suit your needs. They can be opened with any 
  129. plain text editor, and hold a C-language format
  130. string. The placeholders starting with a '%' sign
  131. are used by PTStitcher to insert proper output
  132. values. You can move them, but not delete them
  133. or change order.
  134.  
  135. You need one file with name 'Script' (Windows: 'Script.txt', the
  136. extension is invisible!) in PTStitcher's directory. This scriptfile 
  137. holds the information about how to assemble the panorama. 
  138. See the tutorials section below for details.
  139.  
  140. Getting Started:
  141. ================
  142.  
  143. PTStitcher works best if used as helper for the PTPicker
  144. application. Please use the examples provided in
  145. <http://www.fh-furtwangen.de/~dersch/examples.zip>.
  146. To use PTStitcher as standalone program, get the file
  147. <http://www.fh-furtwangen.de/~dersch/examples2.zip>
  148. with more examples.
  149.  
  150.  
  151. Scripting PTStitcher:
  152. =====================
  153.  
  154. Macintosh:
  155. -----------
  156. PTStitcher is fully scriptable. PTPicker uses this feature to interact
  157. with it. PTStitcher responds to 'DoScript' Apple Events embedded in a 
  158. launch. The data sent should be text consisting of a list of full paths 
  159. in Apple-notation, ie with ':' as delimiter. The syntax has been changed 
  160. for version 1.9.2 and later:
  161.  
  162. -o outputpano scriptfile image1 image2 ....
  163.  
  164. Filenames containing spaces should be quoted. Example:
  165.  
  166. -o "Macintosh HD:panos:result" "Macintosh HD:myscript" "Macintosh HD:image1" "Macintosh HD:image2"
  167.  
  168.  
  169. Windows:
  170. --------
  171. PTStitcher can be controlled via  commandline arguments.PTOptimizer uses 
  172. this feature to interact with it, and lets it generate various trial images. 
  173. The syntax is as follows
  174.  
  175. PTStitcher -o outputpano script.txt image1 image2 ....
  176.  
  177. The outputpano describes the location for the result panorama, ie what 
  178. PTStitcher asks for when run interactively. This file should not exist yet.
  179. The scriptfile is identified via extension 'txt' and need not appear
  180. as second entry, nor has to be named 'script'. 
  181. All input images follow, and are processed in the order they appear 
  182. in the command line.
  183.  
  184.  
  185. Enjoy
  186.  
  187. Helmut Dersch  
  188. der@fh-furtwangen.de
  189.  
  190. -------------------------------------
  191. Spherical Panoramas, Macro Panoramas, 
  192. Free Panorama Software:
  193. <http://www.fh-furtwangen.de/~dersch>
  194.  
  195.  
  196.  
  197.